<html>
<head><meta charset="utf-8"><title>mdbook localization (2nd try) · t-community/l10n · Zulip Chat Archive</title></head>
<h2>Stream: <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/index.html">t-community/l10n</a></h2>
<h3>Topic: <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html">mdbook localization (2nd try)</a></h3>

<hr>

<base href="https://rust-lang.zulipchat.com">

<head><link href="https://rust-lang.github.io/zulip_archive/style.css" rel="stylesheet"></head>

<a name="241679599"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241679599" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241679599">(Jun 06 2021 at 08:07)</a>:</h4>
<p>Hello everyone! Recently i tried another approach for mdbook translation. Basically it is translating the materials paragraph-by-paragraph.<br>
I created a library and a mdbook-processor so all contents get replaced at build-time.</p>



<a name="241679656"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241679656" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241679656">(Jun 06 2021 at 08:08)</a>:</h4>
<p>Taking the Rust reference TOC as an example: Here's what i got: <br>
<a href="https://github.com/crlf0710/rust-bookshelf-l10n/blob/master/reference-l10n/l18n/SUMMARY.md">https://github.com/crlf0710/rust-bookshelf-l10n/blob/master/reference-l10n/l18n/SUMMARY.md</a></p>



<a name="241679670"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241679670" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241679670">(Jun 06 2021 at 08:08)</a>:</h4>
<p>After the book is preprocessed by the preprocessor, it generates a book like this.</p>



<a name="241679690"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241679690" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241679690">(Jun 06 2021 at 08:09)</a>:</h4>
<p><a href="/user_uploads/4715/i5b0WsTV7liiuO1yuLaSlqsB/Lark20210606-160926.png">Lark20210606-160926.png</a></p>
<div class="message_inline_image"><a href="/user_uploads/4715/i5b0WsTV7liiuO1yuLaSlqsB/Lark20210606-160926.png" title="Lark20210606-160926.png"><img src="/user_uploads/4715/i5b0WsTV7liiuO1yuLaSlqsB/Lark20210606-160926.png"></a></div>



<a name="241679755"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241679755" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241679755">(Jun 06 2021 at 08:11)</a>:</h4>
<p>I'm also hoping this approach can generalize to <code>rustdoc</code> usages.   cc <span class="user-mention" data-user-id="232545">@Joshua Nelson</span>  <span class="user-mention" data-user-id="210316">@GuillaumeGomez</span></p>



<a name="241679812"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241679812" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241679812">(Jun 06 2021 at 08:12)</a>:</h4>
<p>This is just a proof-of-concept, and the implementation is quite immature. But i'd love to hear others think about this. cc <span class="user-mention" data-user-id="132040">@Manish Goregaokar</span></p>



<a name="241690322"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241690322" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241690322">(Jun 06 2021 at 12:49)</a>:</h4>
<p><span class="user-mention" data-user-id="116458">@Charles Lew</span> how does it work?</p>



<a name="241690860"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241690860" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241690860">(Jun 06 2021 at 13:02)</a>:</h4>
<p>That really doesn't sound like a good approach to me: that makes one big file where the content is split in paragraph, so instead of trying to make a chapter as a whole, you simply have a paragraph context. And the more languages you support, the worse it becomes. Although, I'm not an expert in i10n so that was just my opinion.</p>



<a name="241690888"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241690888" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241690888">(Jun 06 2021 at 13:03)</a>:</h4>
<p>Actually yeah, how is translation normally done? I don't want to reinvent the wheel</p>



<a name="241693057"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241693057" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241693057">(Jun 06 2021 at 13:55)</a>:</h4>
<p>As far as I know, there are two big approaches:</p>
<ul>
<li>key approach: or each language, you have the list of all keys, you simply add a translation for each key available.</li>
<li>file approach: same file is available in different languages, so you just pick the one you want when needed.</li>
</ul>
<p>The second one seems much better when translating a book</p>



<a name="241693922"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241693922" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241693922">(Jun 06 2021 at 14:15)</a>:</h4>
<p>Yeah let's please not reinvent the wheel here. There are two approaches that make sense for translation: key-based or file-based, as Guillaume said. For mdbook we should do something file based, basically you translate each file. There's no benefit to doing it paragraph by paragraph</p>



<a name="241693924"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241693924" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241693924">(Jun 06 2021 at 14:15)</a>:</h4>
<p>Now! There is _some_  benefit  to _not translating code_</p>



<a name="241693975"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241693975" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241693975">(Jun 06 2021 at 14:16)</a>:</h4>
<p>When you do i18n  you want to figure out what should be localized and what shouldn't be. Typically you would want code examples to not be localized, but you _might_ want comments within them to be!</p>



<a name="241694008"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241694008" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241694008">(Jun 06 2021 at 14:17)</a>:</h4>
<p>for example in rustdoc i hope to be able to make it such that you have key-based localization, but it's easy to write code examples that can themselves be translated</p>



<a name="241694077"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241694077" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241694077">(Jun 06 2021 at 14:19)</a>:</h4>
<p>So for a first pass mdbook translator I'd just have it be able to construct the book from different files, and have a way for those files to work with a system like pontoon</p>



<a name="241694080"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241694080" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241694080">(Jun 06 2021 at 14:19)</a>:</h4>
<p>the hard part is the latter, not the former</p>



<a name="241694123"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241694123" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241694123">(Jun 06 2021 at 14:20)</a>:</h4>
<p>For a second pass translator I'd make it such that code snippets can be shared across languages, ideally without breaking the flow of the english version</p>



<a name="241694137"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241694137" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241694137">(Jun 06 2021 at 14:20)</a>:</h4>
<p>and for a third pass it would be nice if the code snippets can contain translated comments and such</p>



<a name="241694155"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241694155" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241694155">(Jun 06 2021 at 14:21)</a>:</h4>
<p>as far as rustdoc itself, there's already a plan I've laid out, someone needs to do it</p>



<a name="241694156"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241694156" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241694156">(Jun 06 2021 at 14:21)</a>:</h4>
<p><a href="https://internals.rust-lang.org/t/translating-the-stdlib-docs/10384">https://internals.rust-lang.org/t/translating-the-stdlib-docs/10384</a></p>



<a name="241694164"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241694164" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241694164">(Jun 06 2021 at 14:21)</a>:</h4>
<p>this plan does not address the code snippet problem</p>



<a name="241694174"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241694174" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241694174">(Jun 06 2021 at 14:22)</a>:</h4>
<p>but "just copy code snippets" is a decent solution since folks will be notified on updates anyway</p>



<a name="241694225"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241694225" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241694225">(Jun 06 2021 at 14:22)</a>:</h4>
<p>So yeah <span class="user-mention" data-user-id="116458">@Charles Lew</span> I wouldn't do anything other than "translating file by file" here, the tricky thing is making it so that Pontoon or whatever localization tool you wish to use works</p>



<a name="241695852"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241695852" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241695852">(Jun 06 2021 at 15:04)</a>:</h4>
<p>Let me write down my thoughts here: Translating file by file makes a lot of sense if it is simply a "create and deploy" matter. However most of our books, and in the future, API docs, and evolved with time.</p>



<a name="241695859"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241695859" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241695859">(Jun 06 2021 at 15:04)</a>:</h4>
<p>And with time there will be lots and lots of paragraph-level changes.</p>



<a name="241695883"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241695883" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241695883">(Jun 06 2021 at 15:05)</a>:</h4>
<p>Paragraph-level modification detection is mandatory here.</p>



<a name="241695957"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241695957" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241695957">(Jun 06 2021 at 15:07)</a>:</h4>
<p>Maybe it will work for the Rust project to use a system like pontoon for stdlib localization. But from the ecosystem perspective of view. This won't work at all.</p>



<a name="241696018"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241696018" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241696018">(Jun 06 2021 at 15:08)</a>:</h4>
<p>You can't ask 1000 crates to use a shared instance of pontoon to get their API documentation translation work done.</p>



<a name="241696046"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241696046" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241696046">(Jun 06 2021 at 15:09)</a>:</h4>
<p>So my approach is just eliminating pontoon-style systems from this entirely.</p>



<a name="241696270"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241696270" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241696270">(Jun 06 2021 at 15:14)</a>:</h4>
<p>From an ordinary user's view, it's fair for me to want to translated documentation of my own crates into two languages or three.<br>
I certainly don't want to set up a Pontoon-like system on my own box.</p>



<a name="241696291"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241696291" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241696291">(Jun 06 2021 at 15:14)</a>:</h4>
<p>And i hope that stdlib can set up an example that ordinary users can follow.</p>



<a name="241696533"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241696533" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241696533">(Jun 06 2021 at 15:21)</a>:</h4>
<p>My own vision is to create a shared translation-database style thing that every crate can use.</p>



<a name="241696535"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241696535" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241696535">(Jun 06 2021 at 15:21)</a>:</h4>
<hr>



<a name="241696543"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241696543" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241696543">(Jun 06 2021 at 15:21)</a>:</h4>
<p>ok, now putting my own thought aside.</p>



<a name="241696692"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241696692" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241696692">(Jun 06 2021 at 15:25)</a>:</h4>
<p>For mdbook localization, it seems we want a file-level translation utility.</p>



<a name="241696704"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241696704" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241696704">(Jun 06 2021 at 15:25)</a>:</h4>
<p>The previous attempt is <a href="#narrow/stream/226068-t-community.2Fl10n/topic/mdbook.20localisation">https://rust-lang.zulipchat.com/#narrow/stream/226068-t-community.2Fl10n/topic/mdbook.20localisation</a></p>



<a name="241696833"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241696833" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241696833">(Jun 06 2021 at 15:28)</a>:</h4>
<p>The hard part is: What should people do when the original text changes?</p>



<a name="241696916"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241696916" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241696916">(Jun 06 2021 at 15:31)</a>:</h4>
<p>If we don't care about this, does the outcome of previous attempt (with integration of Pontoon) seem sufficient?</p>



<a name="241697103"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241697103" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241697103">(Jun 06 2021 at 15:37)</a>:</h4>
<p>If that is the case, i might try rebasing that pr to the current master.</p>



<a name="241697343"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241697343" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241697343">(Jun 06 2021 at 15:43)</a>:</h4>
<hr>



<a name="241697403"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241697403" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241697403">(Jun 06 2021 at 15:44)</a>:</h4>
<p>oh, another thing i want to mention is that. for translated books people actually do want to see the original text with a mouse hover or something at times. with my solution this is fairly straightforward to implement. While for file-by-file approaches, that would be quite hard.</p>



<a name="241697493"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241697493" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241697493">(Jun 06 2021 at 15:46)</a>:</h4>
<p>I will continue experimenting with my approach outside the scope of the rust project.</p>



<a name="241845697"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241845697" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241845697">(Jun 07 2021 at 21:47)</a>:</h4>
<blockquote>
<p>You can't ask 1000 crates to use a shared instance of pontoon to get their API documentation translation work done.</p>
</blockquote>
<p>You don't need to use pontoon! Pontoon is a convenient way of doing this, but you can also write the files manually. You'd maybe want to build some tooling to better categorize changes, but it's doable. You have a folder with english changes, and you watch it for changes and update your languages accordingly</p>



<a name="241845806"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241845806" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241845806">(Jun 07 2021 at 21:48)</a>:</h4>
<p>so, fwiw, if you want to do it para-by-para, you can: tweak the mdbook input so that you can name paragraphs with keys</p>



<a name="241845872"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241845872" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241845872">(Jun 07 2021 at 21:49)</a>:</h4>
<p>but i'll say this from the get-go: the localization community is used to using good tooling. i'm _strongly_ against reinventing the wheel here</p>



<a name="241845886"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241845886" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241845886">(Jun 07 2021 at 21:49)</a>:</h4>
<p>i18n/l10n are fields with a lot of hidden complexity</p>



<a name="241845912"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241845912" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241845912">(Jun 07 2021 at 21:49)</a>:</h4>
<p>I now work full time on this stuff and I still don't know all the hidden complexities</p>



<a name="241845933"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241845933" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241845933">(Jun 07 2021 at 21:49)</a>:</h4>
<p>doing what the industry as a whole does is a good thing unless something is known to be a poor option</p>



<a name="241846073"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241846073" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241846073">(Jun 07 2021 at 21:51)</a>:</h4>
<p>ultimately i think a key based approach _can work_ if you _really_ care about paragraphs</p>



<a name="241846080"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241846080" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241846080">(Jun 07 2021 at 21:51)</a>:</h4>
<p>BUT</p>



<a name="241846198"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241846198" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241846198">(Jun 07 2021 at 21:52)</a>:</h4>
<p>the format it's currently in is not great. what you want to do is instead make it possible to write a markdown document, and tag each paragraph/section with some key, and have tooling to dump key-para mappings, and tooling to reconstruct those</p>



<a name="241846423"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241846423" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241846423">(Jun 07 2021 at 21:54)</a>:</h4>
<blockquote>
<p>However most of our books, and in the future, API docs, and evolved with time.</p>
</blockquote>
<p>Also, to respond to this explicitly: yes, I'm _very_ well aware, and this is the basis of my opinion on this matter. the existing approaches are decent at handling this kind of evolution. Paragraph-level modification detection is useful but I don't see it as mandatory, especially as you realize that good translations are unlikely to have the same paragraph structure.</p>



<a name="241846528"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241846528" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241846528">(Jun 07 2021 at 21:55)</a>:</h4>
<p>oh, more on pontoon</p>



<a name="241846560"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241846560" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241846560">(Jun 07 2021 at 21:55)</a>:</h4>
<p>my general ethos towards this is not to centralize around any single tool, it's to use that tool to make stuff better</p>



<a name="241846596"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241846596" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241846596">(Jun 07 2021 at 21:55)</a>:</h4>
<p>in fact my original proposal: translate md files as a whole, is _not directly compatible with pontoon_</p>



<a name="241846661"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241846661" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241846661">(Jun 07 2021 at 21:56)</a>:</h4>
<p>and my proposal would be to have a very simple transform to/from pontoon files</p>



<a name="241846730"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241846730" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241846730">(Jun 07 2021 at 21:57)</a>:</h4>
<p>for rustdoc docs i imagine something similar: we may not necessarily use a format directly compatible with pontoon, but we make it easy to convert to a format pontoon likes</p>



<a name="241846745"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241846745" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241846745">(Jun 07 2021 at 21:57)</a>:</h4>
<p>anyway the tricky part for mdbook is code</p>



<a name="241868178"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241868178" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241868178">(Jun 08 2021 at 03:59)</a>:</h4>
<p>Thank you for your insights! This is very helpful.</p>



<a name="241869043"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/241869043" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#241869043">(Jun 08 2021 at 04:16)</a>:</h4>
<blockquote>
<p>especially as you realize that good translations are unlikely to have the same paragraph structure</p>
</blockquote>
<p>Could you explain a little more on this? This might be true but i haven't realized why is that. I thought paragraph-level correspondence are mandatory? Example <a href="https://w3c.github.io/clreq/">multi-language documents</a>.</p>



<a name="242227713"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/242227713" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#242227713">(Jun 10 2021 at 15:46)</a>:</h4>
<p>Not always because the flow might be better in a different way. For _good_ translations. That's a specification so each paragraph has a purpose, which is different.</p>



<a name="242227897"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/242227897" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#242227897">(Jun 10 2021 at 15:48)</a>:</h4>
<p>good translations of prose use their liberty with paragraph/sentence structure. bad translations go sentence by sentence.</p>



<a name="242227932"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/242227932" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#242227932">(Jun 10 2021 at 15:48)</a>:</h4>
<p>we are unlikely to have excelletn translations of technical material that do this but it's still a bad assumption to make</p>



<a name="242268936"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/242268936" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#242268936">(Jun 10 2021 at 20:50)</a>:</h4>
<p>And very exposed to "update issues": as soon as a paragraph is updated, its key isn't the same anymore.</p>



<a name="242303816"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/242303816" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#242303816">(Jun 11 2021 at 05:51)</a>:</h4>
<p><span class="user-mention" data-user-id="210316">@GuillaumeGomez</span> <br>
I'm persuaded that a key is needed here (Leaving the old text only for validation). But I'm still curious why is this alone an issue? Updated text needs updated translation text. And the old one only needs to be "garbage collected".</p>



<a name="242312935"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/242312935" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#242312935">(Jun 11 2021 at 08:06)</a>:</h4>
<p>I think <span class="user-mention" data-user-id="132040">@Manish Goregaokar</span> explained it well enough already. For books, you don't want to use paragraphs as keys nor translate on a paragraph basis.</p>



<a name="242321583"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/242321583" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#242321583">(Jun 11 2021 at 09:37)</a>:</h4>
<p>Yep, but "update issues" are not the reason.</p>



<a name="242321630"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/242321630" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#242321630">(Jun 11 2021 at 09:37)</a>:</h4>
<p>It's one of them (even though certainly one of the less problematic)</p>



<a name="242321730"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/242321730" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#242321730">(Jun 11 2021 at 09:38)</a>:</h4>
<p>Anyway let's move on here =)</p>



<a name="242322124"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/242322124" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#242322124">(Jun 11 2021 at 09:42)</a>:</h4>
<p>I feel synchronization is kind of important...  There're tools like <a href="https://docs.rs/mdbook-transcheck/">https://docs.rs/mdbook-transcheck/</a></p>



<a name="242322265"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/242322265" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#242322265">(Jun 11 2021 at 09:44)</a>:</h4>
<p>it does modification detection within two versions within one single language.</p>



<a name="242322321"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/242322321" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#242322321">(Jun 11 2021 at 09:44)</a>:</h4>
<p>And someone would generate a "patch" in another language and apply to the text.</p>



<a name="242322456"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/226068-t-community/l10n/topic/mdbook%20localization%20%282nd%20try%29/near/242322456" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Charles Lew <a href="https://rust-lang.github.io/zulip_archive/stream/226068-t-community/l10n/topic/mdbook.20localization.20(2nd.20try).html#242322456">(Jun 11 2021 at 09:46)</a>:</h4>
<p>But when structure changes, as <span class="user-mention" data-user-id="132040">@Manish Goregaokar</span> said, this process become hard.</p>



<hr><p>Last updated: Aug 07 2021 at 22:04 UTC</p>
</html>